feat: modernize monorepo, vitest test suite, nextjs 15 dashboard rewrite, lavalink v4, and cloud docs by PhantomNimbi · Pull Request #829 · galnir/Master-Bot

PhantomNimbi · 2026-08-30T19:10:58Z

🚀 Monorepo Modernization, SQLite DB, In-Memory Audio Queue, Vitest Suite & Next.js 15 Web Dashboard Rewrite

This pull request delivers a comprehensive, production-grade modernization of the Master-Bot monorepo. It migrates the database layer to embedded SQLite via Prisma ORM, implements in-memory audio queues (eliminating PostgreSQL and Redis requirements), introduces resilient gateway intent fallback, establishes a 16-test Vitest test suite, rewrites the Next.js 15 App Router web dashboard with 9 feature studios, isolates port bindings across 3 ports (3000, 3001, 3002), and synchronizes extensive documentation across wiki/ and README.md.

🗺️ Monorepo Architecture Overview

flowchart TD
    subgraph Apps["Applications (apps/)"]
        Bot["apps/bot<br/>(Sapphire Framework & discord.js v14)"]
        Dash["apps/dashboard<br/>(Next.js 15 App Router)"]
    end

    subgraph Packages["Shared Packages (packages/)"]
        API["packages/api<br/>(tRPC v11 Routers)"]
        Auth["packages/auth<br/>(NextAuth.js v5)"]
        DB["packages/db<br/>(Prisma ORM Client)"]
        Config["packages/config<br/>(ESLint & Tailwind)"]
    end

    subgraph Storage["Storage & Media Layer"]
        SQLite[("SQLite Database<br/>(file:./db.sqlite)")]
        MemQueue["In-Memory Audio Queue Engine"]
        Lava["Lavalink v4 Audio Server"]
        Discord["Discord Gateway & REST API v10"]
    end

    Dash --> API
    Dash --> Auth
    Bot --> API
    API --> DB
    Auth --> DB
    DB --> SQLite
    Bot --> Lava
    Bot --> MemQueue
    Bot --> Discord
    API --> Discord

📋 Tracking & Linked Issues

Parent Roadmap: Resolves and completes #828 (Master-Bot Maintenance & Modernization Roadmap)
Completed Sub-Roadmaps:
- #836 — Master-Bot Modernization & Runtime Architecture Realignment
- #837 — Sub-Task 1: Diagnostics & Dependency Realignment
- #838 — Sub-Task 2: Resilient Gateway Client & Intent Fallback System
- #839 — Sub-Task 3: SQLite Migration & In-Memory Audio Queues
- #840 — Sub-Task 4: 3-Port Isolation, Docs Sync & Vitest Suite
- #830 — Full Repository Audit & Web Dashboard Complete Rewrite

📦 Key Architectural Deliverables

1. 💾 Zero-Config SQLite Database & In-Memory Audio Queues

SQLite Database: Prisma ORM schema configured with provider = "sqlite" and file:./db.sqlite. JSON string serialization for multi-value array fields.
In-Memory Audio Queue: Replaced Redis/Lua queue storage with native in-memory collection (Queue._tracks), eliminating ioredis and Redis server requirements.
Zero External Dependencies: Anyone cloning the bot can run pnpm install && pnpm dev without configuring external database services or Docker daemons.

2. 🛡️ Resilient Gateway Client & Pure Slash Architecture

DisallowedIntents Fallback: Automatic fallback from privileged GuildMembers intent to standard intents upon DisallowedIntents error at login.
Pure Slash Commands: Enforced pure application command execution (loadMessageCommandListeners: false).

3. 🌐 Next.js 15 Web Dashboard Rewrite & 9 Feature Studios

Glassmorphism UI: Modern frosted-glass dark theme with radial glow accents and responsive layout.
9 Dedicated Studios: Music Studio (/dashboard/music), Broadcaster (/dashboard/broadcast), Audit Logs (/dashboard/logs), Support Tickets (/dashboard/[server_id]/tickets), Twitch Stream Tracking (/dashboard/integrations), Cluster Diagnostics (/dashboard/system), Reminders (/dashboard/reminders), Welcome Greetings (/dashboard/[server_id]/welcome-message), and Command Controls (/dashboard/[server_id]/commands).

4. 🔌 3-Port Isolation & Dynamic NextAuth URL Resolution

Isolated Port Bindings:
- DASHBOARD_PORT=3000 (Next.js Dashboard)
- BOT_PORT=3001 (Bot Runtime & Gateway)
- BOT_API_PORT=3002 (Bot Internal HTTP API)
Dynamic URL Construction: Automatically resolves SSR and public callback URLs from DASHBOARD_PORT, eliminating NEXTAUTH_URL_INTERNAL.

5. 🧪 Vitest Test Suite (16/16 Passing Tests)

8 Test Suites:
- tests/unit/config.test.ts: Turborepo pipeline and package parity.
- tests/unit/scripts/common.test.ts: Monorepo launcher directory resolution.
- tests/unit/env.test.ts: Environment schema validation and 3-port isolation.
- tests/unit/db/prisma.test.ts: PrismaClient singleton and schema models.
- tests/unit/bot/constants.test.ts: Bot directory paths and module locations.
- tests/unit/auth/auth-config.test.ts: NextAuth provider configuration.
- tests/unit/api/routers.test.ts: tRPC procedures across 15 router namespaces.
- tests/integration/dashboard-api.test.ts: Authenticated caller context and security.

6. 📚 Universal Portability & Documentation Sync

100% Relative Paths: Zero hardcoded system paths across the repository.
Documentation: Updated README.md, .env.example, docker-compose.yml, and all 34 wiki/ articles.

📊 Verification Matrix

✓ pnpm test           — 16 / 16 tests passing (100% pass rate)
✓ pnpm run type-check — 0 TypeScript errors across all 7 packages
✓ pnpm run lint       — 0 ESLint warnings or errors (manypkg check valid)
✓ pnpm run build      — Production build succeeded for all packages

…nd update now playing embed

…ue forms

…er logs page

…YouTube device flow auth to console

…s for interactive terminal view

… auth output and file log exclusion

…detection

… audit, and API key gating

…thout disk mutation

…d strip trailing JSON delimiters

…Redis keys in Queue.leave() unconditionally

…nce bot & dashboard - Upgrade Next.js to 15.2.0 and migrate App Router to async request APIs (await params, useParams) - Upgrade Auth.js/NextAuth to v5 beta with server action handlers and safe Discord avatar URL resolution - Upgrade @next/eslint-plugin-next to 15.2.0 and align environment parsers to @t3-oss/env-* 0.13.11 - Replace pure-ESM env wrapper in @master-bot/bot with native Zod schema parsing for 100% CJS compatibility - Wire dynamic feature flags (LAVA_ENABLED, GIFS_ENABLED, TWITCH_ENABLED, NEWS_ENABLED, IGDB_ENABLED) across bot preconditions - Connect automated cross-platform PostgreSQL and Redis service checks (connect-or-auto-launch) - Implement dynamic command help registry and standardized help tables across all 60 slash commands - Enhance web dashboard with active-tab sidebar navigation, server overview statistics, and Redis log streaming - Resolve next-themes hydration mismatch by adding suppressHydrationWarning to root layout

…sabled commands - Group slash commands into structured categories (GIFs & Anime, Twitch, News, Games & Entertainment, General & Utilities) - Filter out categories and individual commands disabled globally via environment feature flags (LAVA_ENABLED, GIFS_ENABLED, TWITCH_ENABLED, NEWS_ENABLED, IGDB_ENABLED) - Display server-specific enable/disable toggles and active status badges for all active commands

…ys monorepo-wide - Configure remoteCipher in application.yml with default endpoint (https://cipher.kikkia.dev/) and support custom YOUTUBE_CIPHER_URL / YOUTUBE_CIPHER_PASSWORD - Pass deterministic Java system properties (-D) for YouTube OAuth, skipInitialization, cipher, and Spotify credentials in launcher scripts - Wire YOUTUBE_CIPHER_URL and YOUTUBE_CIPHER_PASSWORD into @master-bot/bot, @master-bot/api, @master-bot/dashboard env schemas and .env.example - Display active cipher endpoint in dev and production console status banners

…ash command, and fix dual-domain auth

… remote cipher, and active music engine

…nds with fuzzy matching and scoring

…t, and add granular audit log dashboard

…ard control

…on and ticket features

…panel embed

…, and README button

…eholders in app.json

… embeds

PhantomNimbi · 2026-08-31T09:40:32Z

🔄 PR Update: Deferred Interaction Lifecycle & Music Embed Streamlining

sequenceDiagram
    autonumber
    actor User as Discord User
    participant Gateway as Discord Gateway
    participant Bot as Sapphire Bot Command
    participant Channel as Text Channel

    User->>Gateway: Slash Command (/play, /reddit, /game-search)
    Gateway->>Bot: Interaction Create Event
    Bot->>Gateway: deferReply (ephemeral flag)
    Note over Bot: Asynchronous Search and API Fetching
    Bot->>Gateway: editReply (embeds and components)
    Gateway->>Channel: Render Final Response (No Timeout)

📦 Key Enhancements

Deferred Interaction Lifecycle:
- Replaced improper interaction.followUp calls with interaction.editReply across /play, playlist commands (create-playlist, delete-playlist, display-playlist, my-playlists, remove-from-playlist, save-to-playlist), /lyrics, /game-search, /reddit, and /tv-show-search.
- Fixes Unknown interaction token expiration exceptions on deferred slash commands.
Music Embed Formatting:
- Cleaned up NowPlayingEmbed to display standard, reliable Duration field formatting (:stopwatch: 3:45 or :red_circle: Live Stream) without redundant API polling.
- Removed redundant standalone /now-playing slash command, aligning codebase to 74 production slash commands.
Documentation & Reference Sync:
- Updated README.md and wiki/Commands-Reference.md to accurately reflect active slash commands.

🧪 Verification & Status

Type Safety & Build: All packages verified with 0 errors (@master-bot/auth, @master-bot/api, @master-bot/dashboard, @master-bot/bot).

🔗 Pushed Commits

dde449e — fix(bot): resolve deferred interaction lifecycle and streamline music embeds

PhantomNimbi · 2026-08-31T09:56:04Z

🚀 PR Update: Live Interactive Music Embed & Real-Time Progress Bar

flowchart TD
    Start["Track Playback Started"] --> Embed["Render NowPlayingEmbed Progress Bar"]
    Embed --> Loop{"Playback Active?"}
    Loop -->|"5s Interval"| Tick["Update Progress Bar Display"]
    Tick --> Loop
    Loop -->|"Stop or Skip"| Stop["Stop Progress Updater and Clear Interval"]
    Stop --> Finish["Cleanup Resources"]

📦 Key Enhancements

Live ASCII Progress Bar:
- Implemented dynamic progress bar rendering (00:00 ▰▰▰▰▰▰▱▱▱▱▱ 03:45) in nowPlayingEmbed.ts.
- Added intelligent livestream fallback (🔴 LIVE STREAM) for unseekable radio and video feeds.
Embed Progress Auto-Updater:
- Implemented a 5-second interval progress updater in buttonHandler.ts that smoothly advances the player embed during playback.
- Added automatic interval cleanup on pause, stop, skip, and channel cleanup via stopProgressUpdater in buttonsCollector.ts.
Hardened Interaction Reply Handling:
- Added robust reply fallback handling in play.ts to gracefully handle interaction token timeouts without unhandled exceptions.
Documentation Synchronization:
- Updated README.md and wiki/Lavalink.md with details on the interactive channel player embed and progress tracker.

🧪 Verification & Status

Type Safety & Build: Verified all packages (@master-bot/auth, @master-bot/api, @master-bot/dashboard, @master-bot/bot) with 0 errors.
Git Hygiene: Verified zero untracked runtime secrets or local logs via git check-ignore.

🔗 Pushed Commits

fe91b8d — feat(music): add live ascii progress bar and auto-updating player embed

…ntation

PhantomNimbi · 2026-08-31T10:34:49Z

📚 PR Update: Documentation Polish, Cross-Platform Wiki Guides & Initial Hardening

flowchart LR
    subgraph Docs["Documentation Hierarchy"]
        Root["README.md and CONTRIBUTING.md"]
        BotDoc["apps/bot/README.md"]
        Wiki["wiki/*.md (8 Comprehensive Guides)"]
    end
    subgraph Platforms["Cross-Platform Deployment Coverage"]
        Win["Windows (winget, WSL, Memurai)"]
        Mac["macOS (Homebrew, OpenJDK)"]
        Linux["Linux (Debian, Arch, Fedora)"]
        Cloud["Cloud and Heroku (Buildpacks, Docker)"]
    end
    Root --> Wiki
    BotDoc --> Wiki
    Wiki --> Platforms

📦 Key Enhancements

Contributing Guidelines (CONTRIBUTING.md):
- Added comprehensive, professional contribution guidelines covering monorepo architecture, development prerequisites, branching strategy, validation commands, and Conventional Commits reference.
Cross-Platform OS Setup (Windows, macOS, Linux):
- Documented prerequisites and background service management across Windows (winget, WSL, Memurai), macOS (brew, JVM symlinks), and Linux (apt, pacman, dnf) in Setup-and-Deployment.md.
🟣 Heroku Deployment Guide:
- Created dedicated production deployment guide (Heroku-Deployment.md) covering Node.js buildpack and Docker container (heroku.yml) configurations, Heroku Postgres & Redis add-on setup, dyno scaling, and external Lavalink voice routing.
NewsAPI & Dynamic Feature Flags:
- Added NewsAPI setup documentation and dynamic feature flags reference (LAVA_ENABLED, GIFS_ENABLED, TWITCH_ENABLED, NEWS_ENABLED, IGDB_ENABLED) to API-Keys.md.
Application Documentation & Hygiene:
- Created dedicated apps/bot/README.md documenting bot architecture, 74 slash commands, listeners, and preconditions.
- Streamlined descriptions across all markdown documents to cleanly describe Master-Bot as a Discord Bot with a Next.js Web Dashboard.
- Formatted LICENSE.md and aligned all repository references.

🧪 Verification & Status

Type Safety & Build: All packages verified with 0 errors (@master-bot/auth, @master-bot/api, @master-bot/dashboard, @master-bot/bot).
Documentation & Link Integrity: Verified 100% link resolution and command coverage across all Wiki guides and READMEs.
Git Hygiene: Verified zero untracked runtime secrets or local logs via git check-ignore.

🔗 Pushed Commits

c1c09c1 — docs: rename LICENSE to LICENSE.md and format with markdown
243ac33 — docs: audit markdown documentation and add apps/bot README
7e4a0b8 — docs(wiki): add detailed Heroku deployment and cloud hosting guide
6a87c72 — docs: streamline discord bot and dashboard descriptions across documentation
6cd8b92 — docs(wiki): add macOS, Windows, and Linux setup and prerequisite guides
fe6caef — docs: add CONTRIBUTING.md guidelines and link in README
89d8205 — docs: fix tick formatting in contributors section and update badges
fe91b8d — feat(music): add live ascii progress bar and auto-updating player embed

…ashboard rewrite, and cloud docs - Fix dependency installation on clean clones by switching postinstall to db:generate - Add comprehensive Vitest test harness with 8 unit/integration test suites (16 tests, 100% pass) - Rewrite Next.js 15 App Router web dashboard with glassmorphism UI and dedicated feature studios (Music, Broadcast, Integrations, System Telemetry) - Expand backend tRPC v11 API routers with music, broadcast, and system health procedures - Add multi-cloud hosting guides (Render, Railway, Fly.io, Heroku, Docker VPS) with Mermaid architecture diagrams - Update CI/CD workflow with automatic formatting, linting, type-checking, vitest tests, and production build verification

PhantomNimbi · 2026-09-06T02:03:50Z

🌟 Milestone Update: Full Monorepo Audit, Vitest Test Suite & Next.js 15 Dashboard Rewrite

flowchart TD
    subgraph Audit["Phase 1: Foundation Audit (#831)"]
        A1["Fix postinstall to db:generate"] --> A2["turbo.json globalEnv Hardening"]
        A2 --> A3["Standardize ESLint Configs"]
    end

    subgraph Tests["Phase 2: Vitest Test Harness (#832)"]
        T1["vitest.config.ts and tsconfig.test.json"] --> T2["8 Test Suites / 16 Tests (100% Pass)"]
        T2 --> T3["v8 Coverage Pipeline"]
    end

    subgraph Dashboard["Phase 3: Next.js 15 Web Dashboard (#834)"]
        D1["Glassmorphism UI System"] --> D2["9 Dedicated Feature Studios"]
        D2 --> D3["Expanded tRPC v11 API Routers"]
    end

    subgraph Hardening["Phase 4: Docs and Verification (#835)"]
        H1["wiki/Cloud-Hosting.md (Render, Railway, Fly.io)"] --> H2["CI/CD GitHub Actions Pipeline"]
        H2 --> H3["Zero-Error Monorepo Verification"]
    end

    Audit --> Tests
    Tests --> Dashboard
    Dashboard --> Hardening

📋 Roadmap Milestones Completed

All 4 sub-tasks under parent roadmap #830 are fully implemented, hardened, and verified:

✅ Sub-Task 1 (#831): Full Repository Audit, Dependency Resolution & Diagnostic Inventory
✅ Sub-Task 2 (#832): Vitest Test Suite Rebuild & Monorepo Test Harness
✅ Sub-Task 3 (#834): Next.js 15 Web Dashboard Rewrite & Glassmorphism Command Center
✅ Sub-Task 4 (#835): Feature Stabilization, Hardening, Verification & Multi-Agent Docs Sync

📦 Key Highlights Pushed in Latest Commit

Dependency Installation Resolved: Switched postinstall to pnpm db:generate so clean repository clones build Prisma client models without requiring database connection credentials.
Vitest Test Suite: 8 unit/integration test suites (16 tests, 100% pass) with path aliases and ESM module mocks.
Glassmorphism Web Dashboard: Complete rewrite in Next.js 15 App Router featuring 9 dedicated studios:
- 🎵 Music Studio: Lavalink v4 player controls, DSP filters, and playlist management.
- 📢 WYSIWYG Broadcaster: Visual Discord embed builder and direct channel dispatcher.
- 📜 18-Event Audit Stream: Categorized moderation, message, channel, and voice event log selector.
- 🎫 Support Tickets: Custom ticket panels, manager roles, and transcripts.
- 📺 Twitch Streamer Alerts: Real-time streamer notifications.
- ⚡ Cluster Telemetry: Real-time DB latency (SELECT 1), gateway ping, and ecosystem metrics.
- ⏰ Reminders, Welcome Messages, & Command Overrides.
Multi-Cloud Hosting & Wiki Documentation: Added wiki/Cloud-Hosting.md covering Render, Railway, Fly.io, Heroku, and Docker VPS, with syntax-valid Mermaid diagrams across all 8 wiki guides.
CI/CD Pipeline: Hardened .github/workflows/main.yml with automatic Prettier formatting, ESLint checks, Vitest runs, TypeScript type-checks, and production builds.

🧪 Verification Matrix

✓ pnpm test           — 16 / 16 tests passing (100% pass rate)
✓ pnpm run test:types — 0 TypeScript errors across test suites
✓ pnpm run type-check — 4 / 4 workspaces passing (0 errors)
✓ pnpm run lint       — 4 / 4 workspaces passing (0 warnings, 0 errors)
✓ pnpm format         — Cleanly formatted across all 280+ files
✓ pnpm run build      — 11 / 11 Next.js 15 App Router routes generated (0 errors)

🔗 Pushed Commits

a6d5f56 — feat(monorepo): full repository audit, vitest test suite, nextjs 15 dashboard rewrite, and cloud docs

PhantomNimbi · 2026-09-06T02:07:41Z

🚀 PR Update: Root README Alignment & Accurate API Integration (`44606f3` & `171e4c2`)

This update aligns the root README.md with the upstream repository's structure and ensures 100% accuracy across all external API references.

🗺️ Alignment Flow

flowchart TD
    subgraph UpstreamFormat["Upstream README Format Alignment"]
        H1["Heading Hierarchy & Sections"] --> H2["Command Usage Reference Tables"]
        H2 --> H3["Preserved Full Contributors Credits"]
    end

    subgraph APIAccuracy["Accurate API References"]
        A1["Removed Obsolete RAWG API"] --> A2["Configured Twitch / IGDB Game Search"]
    end

    UpstreamFormat --> APIAccuracy

📦 Key Changes

Root README Structure Alignment (README.md):
- Reconstructed the root landing page to match the upstream repository's section hierarchy (## System dependencies, ## Setup bot, ### PostgreSQL, ### Redis, ### Settings (env), # Running the bot, # Commands tables, ## Resources, ## Contributing, ## Contributors ❤️).
Accurate API Configuration:
- Replaced legacy RAWG references with the modern Twitch / IGDB API integration (IGDB_ENABLED, IGDB_CLIENT_ID, IGDB_CLIENT_SECRET).
Preserved Upstream Credits:
- Maintained full upstream contributor recognition list and formatted references.

🧪 Verification & Status

Type Safety & Build: All packages verified with 0 errors (@master-bot/auth, @master-bot/api, @master-bot/dashboard, @master-bot/bot).
Tests: 16/16 Vitest unit and integration tests passing (100%).

🔗 Pushed Commits

171e4c2 — docs(readme): replace obsolete RAWG API references with IGDB API
44606f3 — docs(readme): align root README layout and structure with upstream repository format

…pository format

…osting instructions across Render, Railway, Fly.io, Heroku, Koyeb, Northflank, VPS, and Pterodactyl

…nto unified Cloud Hosting guide

…ogies into unified guides

…ges and root README top-level links

PhantomNimbi · 2026-09-06T02:20:27Z

📚 Milestone Update: Complete Wiki Architecture Rewrite & Top-Level Navigation (`555aab0`)

This milestone delivers a complete, professional rewrite of the repository documentation into a comprehensive 34-page GitHub Wiki Architecture with dedicated category hubs, operating system guides, platform hosting pages, audio sub-guides, dashboard manuals, and top-level README navigation.

🗺️ Full Wiki Architecture & Sub-Page Hierarchy

flowchart TD
    subgraph GlobalNav["Global Navigation"]
        Sidebar["_Sidebar.md"]
        Footer["_Footer.md"]
        Home["Home.md (Wiki Landing)"]
    end

    subgraph Hubs["Top-Level Category Hubs"]
        SetupHub["Setup.md"]
        HostingHub["Hosting.md"]
        LavaHub["Lavalink.md"]
        DashHub["Dashboard.md"]
        ConfigHub["Configuration.md"]
        CmdHub["Commands.md"]
        TestHub["Testing.md"]
    end

    subgraph SubPages["Dedicated Deep-Dive Sub-Pages"]
        OSGuides["Windows / macOS / Linux / Pi / Docker"]
        HostGuides["Render / Railway / Fly.io / Heroku / Koyeb / VPS"]
        AudioGuides["Config / YouTube OAuth / DSP Filters / Nodes"]
        StudioGuides["Architecture / 9 Feature Studios Guide"]
        CmdGuides["Music / Moderation / Utility / /set Settings"]
    end

    Sidebar --> Hubs
    Home --> Hubs
    SetupHub --> OSGuides
    HostingHub --> HostGuides
    LavaHub --> AudioGuides
    DashHub --> StudioGuides
    CmdHub --> CmdGuides

📦 Key Enhancements Delivered

1. 📖 Structured 34-Page GitHub Wiki System

Global Navigation:
- _Sidebar.md: Rendered automatically across every wiki page with organized category trees and direct links.
- _Footer.md: Standardized repository and tracker footer.
- Home.md: Central wiki landing page with interactive section hub and quick start.
Getting Started Category:
- Setup.md: Prerequisites and architecture overview.
- Setup-Windows.md: Windows winget, PostgreSQL, and Memurai/WSL Redis.
- Setup-macOS.md: macOS Homebrew, Java 21 symlinks, and service managers.
- Setup-Linux.md: Ubuntu/Debian, Arch Linux, and Fedora/RHEL.
- Setup-Raspberry-Pi.md: ARM64 Linux installation and swap optimization.
- Docker-Deployment.md: 5-container Docker Compose stack.
Cloud & Platform Hosting Category (8 Platforms):
- Hosting.md: Master hosting directory and environment variables.
- Dedicated sub-pages for Render, Railway, Fly.io, Heroku, Koyeb, Northflank, Linux VPS, and Pterodactyl.
Lavalink & Audio Category:
- Lavalink.md: Master audio architecture and workflow.
- Sub-pages for Configuration, YouTube OAuth, Audio DSP Filters, and Node Topologies.
Web Dashboard Category:
- Dashboard.md: Web management overview.
- Sub-pages for Architecture and 9 Feature Studios.
Commands Reference Category:
- Commands.md: Catalog overview.
- Sub-pages for Music, Moderation, Utility, and Server Settings (/set).
Configuration & Testing:
- Configuration.md, API-Keys.md, and Testing.md.

2. 🔗 Clean Top-Level README Navigation

Updated root README.md resources to strictly link only top-level category hubs, keeping the root page clean and focused while directing users into the structured wiki.

📊 Verification Matrix

✓ pnpm test           — 16 / 16 tests passing (100% pass rate)
✓ pnpm run test:types — 0 TypeScript errors across test suites
✓ pnpm run type-check — 4 / 4 workspaces passing (0 errors)
✓ pnpm run lint       — 4 / 4 workspaces passing (0 warnings, 0 errors)
✓ pnpm format         — Cleanly formatted across all files
✓ pnpm run build      — 11 / 11 Next.js 15 App Router routes generated (0 errors)

🔗 Pushed Commits

555aab0 — docs(wiki): restructure into comprehensive wiki with dedicated sub-pages and root README top-level links
337f5d0 — docs(wiki): consolidate Raspberry Pi setup and Lavalink hosting topologies into unified guides
54ca59f — docs(wiki): remove redundant standalone Heroku page and consolidate into unified Cloud Hosting guide

PhantomNimbi · 2026-09-06T02:23:15Z

🏷️ Quality & Standardization: Project Name Alignment (`0d7da24`)

This update performs a comprehensive audit across all documentation, wiki references, and web dashboard UI components to ensure strict naming fidelity to Master-Bot (hyphenated standard).

📦 Key Updates Included

Root Documentation (README.md):
- Fixed wiki hub link label from [Master Documentation Wiki] to [Master-Bot Documentation Wiki](wiki/Home.md).
- Standardized command catalog overview header to explicitly reference Master-Bot.
Next.js 15 Web Dashboard:
- Updated application metadata title & description in apps/dashboard/src/app/layout.tsx.
- Standardized header branding in apps/dashboard/src/components/logo.tsx.
- Standardized OAuth bot invitation button in apps/dashboard/src/app/page.tsx.
- Clarified feature descriptions in apps/dashboard/README.md.
Wiki Documentation Standardization:
- Standardized category headers and environment configuration guides in wiki/Home.md, wiki/Configuration.md, and wiki/Hosting.md to eliminate ambiguous references.

📊 Verification Status

✓ pnpm test           — 16 / 16 tests passing (100% pass rate)
✓ pnpm run type-check — 4 / 4 workspaces passing (0 errors)
✓ pnpm run lint       — 4 / 4 workspaces passing (0 warnings, 0 errors)

🔗 Pushed Commits

0d7da24 — docs: fix wiki link label in root README to Master-Bot Documentation Wiki
c243cbf — docs: standardize project name to Master-Bot across wiki and readme

…Wiki

…ntent fallback, and 3-port isolation

PhantomNimbi added 20 commits August 28, 2026 21:19

refactor: update dependencies, migrate music engine to Lavalink v4, a…

ab3d4f9

…nd update now playing embed

feat: migrate gif/game search APIs, add documentation, and update iss…

222c868

…ue forms

feat: add cross-platform launch scripts, LAVA_EXTERNAL check, and own…

1dfd3ca

…er logs page

feat: add YOUTUBE_API_KEY to env schemas and documentation

0dfb44b

fix: update Lavalink plugins config and format runner console banner

ffd29db

feat: add cross-platform port clearing before launch and audit fixes

943b93a

fix: resolve QueueStore script paths and reddit command build errors

521e382

fix: resolve Lavalink host mapping, searchSong node search, and echo …

c9b851f

…YouTube device flow auth to console

fix: remove console clear and format YouTube OAuth device flow prompt…

1727977

…s for interactive terminal view

refactor: modularize dev and start launch scripts with direct console…

be4c75a

… auth output and file log exclusion

fix: remove shell option from spawn for DEP0190 and refine auth line …

b6bac68

…detection

feat: auto db push, voice gateway raw packet routing, full dependency…

effc4c1

… audit, and API key gating

fix(launcher): strictly in-memory YouTube refresh token management wi…

e13c2dd

…thout disk mutation

fix(launcher): deduplicate in-memory YouTube refresh token capture an…

47a4e66

…d strip trailing JSON delimiters

fix(music): trigger queue.next() on play command when idle and clear …

7ddefd4

…Redis keys in Queue.leave() unconditionally

feat(music): improve skip/skipto jump logic, recreate youtube-auth sl…

0026591

…ash command, and fix dual-domain auth

docs: update README, wiki, and agent reference to reflect Next.js 15,…

06d5bba

… remote cipher, and active music engine

PhantomNimbi mentioned this pull request Aug 30, 2026

Master-Bot Maintenance & Fix Roadmap #828

Open

PhantomNimbi added 9 commits August 30, 2026 12:28

feat(music): implement interactive music-trivia and stop-trivia comma…

a5f9bdb

…nds with fuzzy matching and scoring

feat(settings): consolidate /set slash command, enhance welcome forma…

9c6259e

…t, and add granular audit log dashboard

feat: add moderation suite and thread-based ticket system with dashbo…

8af561f

…ard control

docs: update README, Dashboard guide, and Wiki reference for moderati…

53f7c7d

…on and ticket features

feat(tickets): render formatted custom ticket greeting inside ticket …

b4da0e0

…panel embed

docs(readme): restore contributors section to repository README

00f6193

feat(heroku): add 1-click Heroku deployment engine, app.json manifest…

950f8bb

…, and README button

feat(heroku): add YOUTUBE_API_KEY and preserve manifest template plac…

255deac

…eholders in app.json

chore(deployment): remove unsupported heroku deployment

d415cd8

fix(bot): resolve deferred interaction lifecycle and streamline music…

dde449e

… embeds

feat(music): add live ascii progress bar and auto-updating player embed

fe91b8d

PhantomNimbi added 7 commits August 31, 2026 03:13

docs: fix tick formatting in contributors section and update badges

89d8205

docs: add CONTRIBUTING.md guidelines and link in README

fe6caef

docs(wiki): add macOS, Windows, and Linux setup and prerequisite guides

6cd8b92

docs: streamline discord bot and dashboard descriptions across docume…

6a87c72

…ntation

docs(wiki): add detailed Heroku deployment and cloud hosting guide

7e4a0b8

docs: audit markdown documentation and add apps/bot README

243ac33

docs: rename LICENSE to LICENSE.md and format with markdown

c1c09c1

PhantomNimbi changed the title ~~feat: modernize monorepo, upgrade Lavalink v4 & cipher, enhance dashboard, and fix auth/tooling~~ feat: modernize monorepo, vitest test suite, nextjs 15 dashboard rewrite, lavalink v4, and cloud docs Sep 6, 2026

PhantomNimbi added 6 commits September 5, 2026 19:10

docs(readme): align root README layout and structure with upstream re…

44606f3

…pository format

docs(readme): replace obsolete RAWG API references with IGDB API

171e4c2

docs(wiki): expand cloud deployment guide with comprehensive manual h…

72d90e2

…osting instructions across Render, Railway, Fly.io, Heroku, Koyeb, Northflank, VPS, and Pterodactyl

docs(wiki): remove redundant standalone Heroku page and consolidate i…

54ca59f

…nto unified Cloud Hosting guide

docs(wiki): consolidate Raspberry Pi setup and Lavalink hosting topol…

337f5d0

…ogies into unified guides

docs(wiki): restructure into comprehensive wiki with dedicated sub-pa…

555aab0

…ges and root README top-level links

docs: standardize project name to Master-Bot across wiki and readme

c243cbf

PhantomNimbi added 5 commits September 5, 2026 19:25

docs: fix wiki link label in root README to Master-Bot Documentation …

0d7da24

…Wiki

feat: modernize architecture with SQLite DB, in-memory audio queue, i…

0c6b44d

…ntent fallback, and 3-port isolation

Remove unused env keys

62b3149

Remove unused env keys

cf4f5ee

Fix Lavalink jar link

1fc145a

Navigation Menu

feat: modernize monorepo, vitest test suite, nextjs 15 dashboard rewrite, lavalink v4, and cloud docs - #829

feat: modernize monorepo, vitest test suite, nextjs 15 dashboard rewrite, lavalink v4, and cloud docs#829
PhantomNimbi wants to merge 67 commits into
galnir:mainfrom
PhantomNimbi:main

PhantomNimbi commented Aug 30, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

Uh oh!

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

PhantomNimbi commented Aug 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Monorepo Modernization, SQLite DB, In-Memory Audio Queue, Vitest Suite & Next.js 15 Web Dashboard Rewrite

🗺️ Monorepo Architecture Overview

📋 Tracking & Linked Issues

📦 Key Architectural Deliverables

1. 💾 Zero-Config SQLite Database & In-Memory Audio Queues

2. 🛡️ Resilient Gateway Client & Pure Slash Architecture

3. 🌐 Next.js 15 Web Dashboard Rewrite & 9 Feature Studios

4. 🔌 3-Port Isolation & Dynamic NextAuth URL Resolution

5. 🧪 Vitest Test Suite (16/16 Passing Tests)

6. 📚 Universal Portability & Documentation Sync

📊 Verification Matrix

Uh oh!

PhantomNimbi commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔄 PR Update: Deferred Interaction Lifecycle & Music Embed Streamlining

📦 Key Enhancements

🧪 Verification & Status

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 PR Update: Live Interactive Music Embed & Real-Time Progress Bar

📦 Key Enhancements

🧪 Verification & Status

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📚 PR Update: Documentation Polish, Cross-Platform Wiki Guides & Initial Hardening

📦 Key Enhancements

🧪 Verification & Status

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🌟 Milestone Update: Full Monorepo Audit, Vitest Test Suite & Next.js 15 Dashboard Rewrite

📋 Roadmap Milestones Completed

📦 Key Highlights Pushed in Latest Commit

🧪 Verification Matrix

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 PR Update: Root README Alignment & Accurate API Integration (44606f3 & 171e4c2)

🗺️ Alignment Flow

📦 Key Changes

🧪 Verification & Status

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📚 Milestone Update: Complete Wiki Architecture Rewrite & Top-Level Navigation (555aab0)

🗺️ Full Wiki Architecture & Sub-Page Hierarchy

📦 Key Enhancements Delivered

1. 📖 Structured 34-Page GitHub Wiki System

2. 🔗 Clean Top-Level README Navigation

📊 Verification Matrix

🔗 Pushed Commits

Uh oh!

PhantomNimbi commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🏷️ Quality & Standardization: Project Name Alignment (0d7da24)

📦 Key Updates Included

📊 Verification Status

🔗 Pushed Commits

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

PhantomNimbi commented Aug 30, 2026 •

edited

Loading

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

PhantomNimbi commented Aug 31, 2026 •

edited

Loading

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

🚀 PR Update: Root README Alignment & Accurate API Integration (`44606f3` & `171e4c2`)

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

📚 Milestone Update: Complete Wiki Architecture Rewrite & Top-Level Navigation (`555aab0`)

PhantomNimbi commented Sep 6, 2026 •

edited

Loading

🏷️ Quality & Standardization: Project Name Alignment (`0d7da24`)